Walkthrough

The PR migrates two instances of a ChatGPT example application from a manual MCP server handler pattern to modern OpenAI Apps SDK decorator-based annotations. Internal functions (_list_tools, _list_resources, _handle_read_resource, _call_tool_request) are replaced with @app.tool and @mcp.resource decorated functions, and the widget template URI is updated with a new timestamp.

Changes

Sequence Diagram

sequenceDiagram
    participant Client
    participant App as OpenAI App<br/>(Decorated)
    participant Tool as flip_coin()<br/>@app.tool
    participant Resource as get_widget_html()<br/>@mcp.resource
    
    rect rgb(200, 220, 240)
    Note over Client,App: New Decorator-Based Approach
    end
    
    Client->>App: Request tool list
    App->>App: Scan @app.tool decorators
    App-->>Client: Tool metadata (flip_coin)
    
    Client->>App: Execute flip_coin tool
    App->>Tool: Invoke decorated function
    Tool->>Tool: Generate random result
    Tool-->>App: Return {flipResult: ...}
    App-->>Client: Structured output
    
    Client->>App: Request widget resource
    App->>Resource: Invoke @mcp.resource
    Resource->>Resource: Serve WIDGET.html
    Resource-->>App: HTML string
    App-->>Client: Widget content

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

• Verify decorator annotations (@app.tool, @mcp.resource) are syntactically correct and properly configured with metadata (name, description, structured_output, etc.)
• Confirm flip_coin() structured output format matches OpenAI Apps SDK expectations
• Validate _tool_meta() returns widget descriptor under correct JSON keys ("openai.com/widget", "openai/outputTemplate")
• Check whether both modified files are production examples or if one is test/fixture data; ensure consistency is intentional
• Review widget template_uri timestamp change to confirm it reflects actual build artifact

Possibly related PRs

• Add mcp-agent cloud compatibility to basic slack agent example #494: Converts example agents to cloud-compatible decorator-driven tool integration pattern using @app.tool annotations

Suggested reviewers

• saqadri
• andrew-lastmile

Poem

🐰 A rabbit hops with decorator cheer,
No more manual routes to fear!
@app.tool and @mcp.resource shine,
Simple, clean, and oh-so-divine,
Flip a coin with elegance true,
The new way gleams in morning dew! ✨

Pre-merge checks and finishing touches

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

_{Comment @coderabbitai help to get the list of available commands and usage tips.}